home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / pmafm.z / pmafm
Text File  |  1998-10-20  |  8KB  |  198 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMAAAAFFFFMMMM((((1111))))                                                              PPPPMMMMAAAAFFFFMMMM((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmaaaaffffmmmm - Performance Co-Pilot archive folio manager
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmaaaaffffmmmm _f_o_l_i_o_n_a_m_e [_c_o_m_m_a_n_d [_a_r_g ...]]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      A collection of one or more Performance Co-Pilot (PCP) archive logs may
  16.      be combined with a control file to produce a PCP archive folio.  Archive
  17.      folios are created using either mmmmkkkkaaaaffff(1) or the interactive ``record
  18.      mode'' services of PCP clients like ppppmmmmcccchhhhaaaarrrrtttt(1).
  19.  
  20.      ppppmmmmaaaaffffmmmm provides a number of services that may be used to process folios.
  21.      In particular, it provides support for execution of PCP tools using one
  22.      or more of the component archive logs within an archive folio.
  23.  
  24.      The target folio is identified by the folio control file _f_o_l_i_o_n_a_m_e.  The
  25.      syntax for a folio control file is described in mmmmkkkkaaaaffff(1).
  26.  
  27.      If present, the command and arguments following _f_o_l_i_o_n_a_m_e are interpreted
  28.      and executed as a single command, otherwise commands are read from
  29.      standard input.
  30.  
  31.      The following commands are supported.
  32.  
  33.      aaaarrrrcccchhhhiiiivvvveeeessss
  34.           Subsequent commands apply to all archives in the folio.
  35.  
  36.      aaaarrrrcccchhhhiiiivvvveeeessss _N[,...]
  37.           Archives within a folio are numbered 1, 2, etc.  Subsequent commands
  38.           are restricted to apply only to the designated archives.
  39.  
  40.      aaaarrrrcccchhhhiiiivvvveeeessss _n_a_m_e[,...]
  41.           Archives within a folio have unique names.  Subsequent commands are
  42.           restricted to apply only to the designated archives.
  43.  
  44.      cccchhhheeeecccckkkk
  45.           Validate the presence and format of each file in the folio and the
  46.           component archives.
  47.  
  48.      hhhheeeellllpppp
  49.           A brief reminder of the command syntax.  ???? is a synonym for hhhheeeellllpppp.
  50.  
  51.      hhhhoooossssttttssss
  52.           Subsequent commands apply to all archives in the folio.
  53.  
  54.      hhhhoooossssttttssss _h_o_s_t_n_a_m_e[,...]
  55.           Subsequent commands are restricted to apply only to those archives
  56.           that match the designated hostnames.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMAAAAFFFFMMMM((((1111))))                                                              PPPPMMMMAAAAFFFFMMMM((((1111))))
  71.  
  72.  
  73.  
  74.      lllliiiisssstttt [vvvveeeerrrrbbbboooosssseeee]
  75.           Display the contents of the folio.  By default the control header
  76.           and the ordinal number, hostname and archive base name for each
  77.           archive in the folio.  The vvvveeeerrrrbbbboooosssseeee option causes ppppmmmmaaaaffffmmmm to dump the
  78.           label record from each archive using ppppmmmmdddduuuummmmpppplllloooogggg ----llll.
  79.           The first named archive in the folio is assumed to be associated
  80.           with the default host for any tool that tries to replay multiple
  81.           archives from the folio.
  82.  
  83.      qqqquuuuiiiitttt
  84.           Exit ppppmmmmaaaaffffmmmm.
  85.  
  86.      rrrreeeemmmmoooovvvveeee
  87.           Echo on standard output the sssshhhh(1) commands required to remove all of
  88.           the physical files associated with this archive folio.
  89.  
  90.      rrrreeeeppppeeeeaaaatttt _t_o_o_l [_a_r_g ...]
  91.           Execute the known PCP _t_o_o_l once per selected archive.  For example,
  92.           the command
  93.                repeat pmval -t60 irix.kernel.all.load
  94.           would run ppppmmmmvvvvaaaallll(1) once per archive, with an appropriate ----aaaa
  95.           argument.
  96.  
  97.      rrrreeeeppppllllaaaayyyy
  98.           Some archive folios are created by tools (e.g. ppppmmmmcccchhhhaaaarrrrtttt(1)) that
  99.           provide sufficient information to allow all of the information in
  100.           all of the archives of a folio to be replayed.
  101.  
  102.      [rrrruuuunnnn] _t_o_o_l [_a_r_g ...]
  103.           Execute the known PCP _t_o_o_l on the selected archives.  Some PCP tools
  104.           are able to process multiple concurrent archives, and in this case
  105.           the tool is run once with the list of all selected archives passed
  106.           via a ----aaaa argument.  Otherwise, this command is synonymous with
  107.           rrrreeeeppppeeeeaaaatttt.
  108.  
  109.      sssseeeelllleeeeccccttttiiiioooonnnnssss
  110.           Display those archives that would be selected for processing with a
  111.           rrrreeeeppppeeeeaaaatttt, rrrreeeeppppllllaaaayyyy or rrrruuuunnnn command.
  112.  
  113.      The restrictions via any hhhhoooossssttttssss and aaaarrrrcccchhhhiiiivvvveeeessss commands are conjuncted.
  114.      These restrictions serve to limit the specific archives processed in the
  115.      subsequent rrrreeeeppppeeeeaaaatttt, rrrreeeeppppllllaaaayyyy, rrrruuuunnnn and sssseeeelllleeeeccccttttiiiioooonnnnssss commands.  By default, all
  116.      archives are selected.
  117.  
  118.      Keywords in commands may be abbreviated provided no ambiguity is
  119.      introduced, e.g.  hhhheeeellllpppp, hhhheeeellll and hhhheeee are synonymous, but hhhh is ambiguous.
  120.  
  121. FFFFIIIILLLLEEEESSSS
  122.      ////vvvvaaaarrrr////ppppccccpppp////ccccoooonnnnffffiiiigggg////ppppmmmmaaaaffffmmmm////* control files that define the behavior of each
  123.                              PCP tool known to ppppmmmmaaaaffffmmmm.  This information may be
  124.                              customized or extended, see
  125.                              /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_a_f_m/_p_c_p for documentation of
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. PPPPMMMMAAAAFFFFMMMM((((1111))))                                                              PPPPMMMMAAAAFFFFMMMM((((1111))))
  136.  
  137.  
  138.  
  139.                              the syntax and semantics of these files.
  140.      $$$$HHHHOOOOMMMMEEEE////....ppppccccpppp////ppppmmmmaaaaffffmmmm////*      User customization of the control files.  All
  141.                              files in this directory are treated in the same
  142.                              manner as control files in the
  143.                              /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_a_f_m directory.
  144. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  145.      mmmmkkkkaaaaffff(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmvvvviiiieeeewwww(1), PPPPMMMMAAAAPPPPIIII(3) and ppppmmmmRRRReeeeccccoooorrrrddddSSSSeeeettttuuuupppp(3).
  146. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  147.      Many, but all are intended to be easily understood.
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                         PPPPaaaaggggeeee 3333
  195.  
  196.  
  197.  
  198.